package libra.openfeign.callLocal;

import java.util.Map;

import org.bouncycastle.cert.ocsp.RespData;
import org.junit.experimental.theories.FromDataPoints;
import org.springframework.boot.actuate.autoconfigure.metrics.export.dynatrace.DynatraceProperties.V1;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.CookieValue;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RequestPart;
import org.springframework.web.multipart.MultipartFile;

import com.alibaba.nacos.shaded.io.grpc.Status.Code;

/**
 * 基于OpenFeign的客户端负载均衡技术(指定IP调用)接口式、注解式编程
 * 使用@FeignClient注解标识OpenFeign定义的服务调用接口类
 * 		name/value[必选]：指定当前FeignClient的名称。如果项目属于微服务，该属性会视为微服务名(即被调用服务的spring.application.name)，用于服务发现
 * 		url[可选]: 指定FeignClient的调用ip地址，一般用于调试。如果配置该属性，则OpenFeign可以不需要spring-cloud-starter-loadbalancer依赖
 * 		path[可选]: 定义当前FeignClient的统一前缀，当我们项目中配置了server.context-path,server.servlet-path时使用
 *		decode404[可选]:当发生http 404错误时，如果该字段位true，会调用decoder进行解码(正常json返回)，否则抛出FeignException
 * 		configuration[可选]: Feign配置类，可以自定义Feign的Encoder、Decoder、LogLevel、Contract，一般在对单个服务提供方进行定制配置时使用
 * 		fallback[可选]: 定义容错的处理类，当调用远程接口失败或超时时，会调用对应接口的容错逻辑，fallback指定的类必须实现@FeignClient标记的接口
 * 		fallbackFactory[可选]: 工厂类，用于生成fallback类示例，通过这个属性我们可以实现每个接口通用的容错逻辑，减少重复的代码
 *	!!!：fallbackFactory属性用来处理通用的“服务降级”，OpenFeign自身无法独立完成该功能点，需要配合Hystrix处理
 */
@FeignClient( 
	name="UnUseCloud", contextId="test", url="${local}", path="${server.servlet.context-path}/local", 
	decode404=true 
) 
public interface OpenFeignClientLocal {
	// 测试请求头参数接收
	@RequestMapping("header")
	public Object header(@RequestHeader("testHeader") String header );
	
	// 测试请求cookie参数接收
	@RequestMapping("cookie")
	public Object cookie(@CookieValue("testCookie") String cookie );
	
	// 测试请求参数接收
	@RequestMapping("param")
	public Object param(@RequestParam("param") String param );
	
	// 测试Rest请求参数接收
	@RequestMapping("restParam/{val}")
	public Object restParam( @PathVariable("val") String val );
	
	// 测试Json请求参数接收
	@RequestMapping("json")
	public Object json( @RequestBody Map map );
	
	/*
	 * 测试File请求参数接收
	 * !!!：必须要设置consumer属性指定请求类型为multipart/form-data，否则OpenFeign无法处理file请求
	 * 	produces：指定返回值类型，并且可以设置返回值类型和返回值的字符编码
	 * 		例：produces="MediaType.APPLICATION_JSON_VALUE;charset=utf-8"
	 * 	consumes：指定处理请求当中的提交内容类型(Content-Type)：application/json、text/html等
	 * 		例：consumes={MediaType.MULTIPART_FORM_DATA_VALUE}
	 */
	@RequestMapping(value="file", consumes={MediaType.MULTIPART_FORM_DATA_VALUE})
	public Object file(@RequestPart("file") MultipartFile file, @RequestParam("param")String param );
	
	// 测试404请求(开启了@FeignClient的decode404)
	@RequestMapping("withDecode404")
	public Object withDecode404();
}
